home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Skunkware 5
/
Skunkware 5.iso
/
man
/
cat.3
/
OwnSelect.3
< prev
next >
Wrap
Text File
|
1995-07-25
|
4KB
|
67 lines
TTTTkkkk____OOOOwwwwnnnnSSSSeeeelllleeeeccccttttiiiioooonnnn((((3333)))) TTTTkkkk (((( )))) TTTTkkkk____OOOOwwwwnnnnSSSSeeeelllleeeeccccttttiiiioooonnnn((((3333))))
_________________________________________________________________
NNNNAAAAMMMMEEEE
Tk_OwnSelection - make a window the owner of the primary
selection
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
####iiiinnnncccclllluuuuddddeeee <<<<ttttkkkk....hhhh>>>>
TTTTkkkk____OOOOwwwwnnnnSSSSeeeelllleeeeccccttttiiiioooonnnn(_t_k_w_i_n, _p_r_o_c, _c_l_i_e_n_t_D_a_t_a)
AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
Tk_Window _t_k_w_i_n (in) Window that is to
become new selection
owner.
Tk_LostSelProc *_p_r_o_c (in) Procedure to invoke
when _t_k_w_i_n loses
selection ownership
later.
ClientData _c_l_i_e_n_t_D_a_t_a (in) Arbitrary one-word
value to pass to
_p_r_o_c.
_________________________________________________________________
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
TTTTkkkk____OOOOwwwwnnnnSSSSeeeelllleeeeccccttttiiiioooonnnn arranges for _t_k_w_i_n to become the new owner
of the primary selection. After this call completes, future
requests for the selection will be directed to handlers
created for _t_k_w_i_n using TTTTkkkk____CCCCrrrreeeeaaaatttteeeeSSSSeeeellllHHHHaaaannnnddddlllleeeerrrr. When _t_k_w_i_n
eventually loses the selection ownership, _p_r_o_c will be
invoked so that the window can clean itself up (e.g. by
unhighlighting the selection). _P_r_o_c should have arguments
and result that match the type TTTTkkkk____LLLLoooossssttttSSSSeeeellllPPPPrrrroooocccc:
typedef void Tk_LostSelProc(ClientData _c_l_i_e_n_t_D_a_t_a);
The _c_l_i_e_n_t_D_a_t_a parameter to _p_r_o_c is a copy of the _c_l_i_e_n_t_D_a_t_a
argument given to TTTTkkkk____OOOOwwwwnnnnSSSSeeeelllleeeeccccttttiiiioooonnnn, and is usually a pointer
to a data structure containing application-specific
information about _t_k_w_i_n.
Once a window has become selection owner, it will remain
owner until either the window is deleted or until some other
window claims ownership. There is no way for a window to
disavow ownership of the selection once it has received it.
KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
own, selection owner
Page 1 (printed 7/23/95)